/*
 * Copyright 2020-2030 the original author or authors.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      https://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
*/

package com.gitee.minimalismstyle.fresh.flowable.api.feign

import org.springframework.web.bind.annotation.*
import com.gitee.minimalismstyle.fresh.common.core.domain.R
import com.gitee.minimalismstyle.fresh.flowable.api.annotation.FlowableClient
import com.gitee.minimalismstyle.fresh.flowable.api.config.FlowableFeignConfig
import com.gitee.minimalismstyle.fresh.flowable.api.feign.model.RestIdentityLink

/**
 * ProcessInstanceIdentityLinks
 * @author maoxiaodong
 */
@FlowableClient(configuration = [FlowableFeignConfig::class])
interface ProcessInstanceIdentityLinksApi {


    /**
     * Note that the groupId in Response Body will always be null, as it’s only possible to involve users with a process-instance.
     */
    @GetMapping("/runtime/process-instances/{processInstanceId}/identitylinks")
    fun listProcessInstanceIdentityLinks(
        @PathVariable("processInstanceId") processInstanceId: String
    ): R<Any>

    /**
     * Note that the groupId in Response Body will always be null, as it’s only possible to involve users with a process-instance.
     */
    @PostMapping("/runtime/process-instances/{processInstanceId}/identitylinks")
    fun createProcessInstanceIdentityLinks(
        @PathVariable("processInstanceId") processInstanceId: String,
        @RequestBody(required = false) body: RestIdentityLink?
    ): R<RestIdentityLink>

    /**
     * Get a specific involved people from process instance
     */
    @GetMapping("/runtime/process-instances/{processInstanceId}/identitylinks/users/{identityId}/{type}")
    fun getProcessInstanceIdentityLinks(
        @PathVariable("processInstanceId") processInstanceId: String,
        @PathVariable("identityId") identityId: String,
        @PathVariable("type") type: String
    ): R<RestIdentityLink>

    /**
     * Remove an involved user to from process instance
     */
    @DeleteMapping("/runtime/process-instances/{processInstanceId}/identitylinks/users/{identityId}/{type}")
    fun deleteProcessInstanceIdentityLinks(
        @PathVariable("processInstanceId") processInstanceId: String,
        @PathVariable("identityId") identityId: String,
        @PathVariable("type") type: String
    ): R<Any>
}